home *** CD-ROM | disk | FTP | other *** search
/ Internet Warrior 1993 July / Internet Warrior No. 1 July 1993 - Austin Code Works.ISO / tcpip / cmupcip / readme.cmu < prev    next >
Encoding:
Text File  |  1993-01-10  |  5.9 KB  |  122 lines
  1.     In order to build the CMU-PCIP distribution, you should have gotten
  2. one of the following sets of files:
  3.  
  4. from the arpanet:
  5. -------------
  6. readme        - this file
  7. install.bat    - a batch file to make installation easier
  8. tarread.exe    - a tar file reading program
  9. root.tar    - a tar file of the root directory
  10. include.tar    - a tar file of the include directory
  11. srcdev.tar    - a tar file of the srcdev directory
  12. srclib.tar    - a tar file of the srclib directory
  13. srccmd.tar    - a tar file of the srccmd directory
  14. doc.tar        - a tar file of the doc and man directorys (OPTIONAL)
  15. bootp.tar    - a tar file of a UNIX BOOTP server (OPTIONAL)
  16.  
  17. or from BITNET:
  18. ---------------
  19. read.me        - this file
  20. install.bat    - a batch file to make installation easier
  21. unboo.c        - a boo file reading program
  22. tarread.boo    - a boo file of a tar file reading program
  23. root.boo    - a boo file of the root directory
  24. include.boo    - a boo file of the include directory
  25. srcdev.boo    - a boo file of the srcdev directory
  26. srclib*.boo    - boo files of the srclib directory
  27. srccmd*.boo    - boo files of the srccmd directory
  28. doc*.boo    - boo files of the doc and man directorys (OPTIONAL)
  29. bootp.boo    - a boo file of a UNIX BOOTP server (OPTIONAL)
  30.  
  31.     Note that all .tar and .exe files are binary files.  These MUST be
  32. transferred to your pc in BINARY/OCTET/IMAGE mode.  If tarread.exe is not in
  33. the correct format, you are likely to hang your pc, or if your lucky you will
  34. get an error about "Program to large to fit in memory" when you run it.  The
  35. program "tarread" is a very simple program that knows the basic format of UNIX
  36. tar files.  It's not very intelligent, so use it carefully.  Sources are
  37. included.
  38.  
  39.     Now, the first step is to put the tar/boo files in the main directory
  40. on your pc where you want pcip to reside, ie. something like c:\pcip.
  41.  
  42.     The second step in building CMU-PCIP is to assemble the distribution.
  43.  
  44. ARPANET (tar file) distribution
  45. -------------------------------
  46. If you have the tar file distribution, the install.bat file will install your
  47. files if you invoke it with the tarfiles option.  I.e. say: "install tarfiles"
  48. and install will have tarread extract all of your files.  You must execute
  49. this from the directory where you placed your files (i.e. c:\pcip).  You can
  50. check what files are on your tar files by saying "tarread tv filename".  By
  51. default tarread does newline to CRLF transformations, but this can be disabled
  52. with the "z" command.  The tar files distributed have only LF's in them so 
  53. don't change install to use this.  The "w" option to tarread will make tarread
  54. ask you to confirm everything it does before it does it.
  55.  
  56. BITNET (boo file) distribution
  57. ------------------------------
  58. If you have the boo file distribution, the install.bat file will install you
  59. files if you invoke it with the boofiles option.  I.e. say "install boofiles",
  60. and install will compile the unboo program, unboo all your files, and then
  61. have tarread extract all of your files, as described above.
  62.  
  63.     The next step is to set up your development environment.  The
  64. developement environment I currently use consists of Microsoft C V4.00,
  65. Microsoft Link V3.51, Microsoft Exemod, Microsoft MASM V4.00, Microsoft
  66. Make V4.02, Microsoft Mapsym V4.00 and Microsoft Symdeb.  Microsoft C V3.00
  67. and Microsoft MASM V3.00 will also work.  You should have all of these
  68. programs if you have the Microsoft C compiler and Microsoft Macro Assembler
  69. packages.  I suspect that the IBM C compiler V1.0 should also work.
  70.  
  71.     To install this release and integrate it with the Microsoft
  72. compiler, first edit autoexec.bat in your root directory. Set the INCLUDE
  73. variable to the name of the directory where the compiler include files are.
  74. Set the LIB variable to the name of the directory where the compiler libraries
  75. are and the directory where the pcip libraries are.  For example, I have:
  76.  
  77. set INCLUDE=c:\msc\include
  78. set LIB=c:\msc\lib;c:\pcip\lib
  79.  
  80.     The pcip include files are picked up by the -I switch in the compiler
  81. instead of the environment variable.  This is because the search path named
  82. with the -I switch is searched before the environment variable, thus making
  83. sure that files with the same name are picked up from the correct place
  84. (i.e. stdio.h).  It can be placed in the environment variable if you don't
  85. mind other programs (i.e. non-pcip) you compile to include the pcip include
  86. files.
  87.  
  88.     The fourth step is to install the correct set of makefiles in each of
  89. your directories.  A makefile has been provided for each source directory
  90. for both versions 3.0 and 4.0 of MSC.  Also, versions are provided for
  91. building either DEBUG versions, or NON-DEBUG versions.  Note that until now,
  92. PCIP has always been the DEBUG version.  The NON-DEBUG versions are up to
  93. 10k smaller.  At CMU we are distributing NON-DEBUG versions to the populace,
  94. and giving DEBUG versions to the network/datacomm staff.  To install the
  95. version you want, invoke install with either the "3d", "3n", "4d" or "4n"
  96. option.  I.e. say "install 4d" to get the v4.0 MSC/DEBUG version.
  97.  
  98.     The last step is to compile the distribution via "make".  The make
  99. batch file must again be executed from the top level pcip directory or else
  100. you may accidentally run MSC make.exe from your path.  The make command takes
  101. a number of options.  Saying "make srclib" will compile only srclib.
  102. "make srccmd" will compile only srccmd.  Saying "make all" will compile both.
  103.  
  104.     The "DIFFRNCS" file to has a description of differences between the
  105. CMU version of PCIP and MIT's cross-compiled version.  Another batch file,
  106. "clean.bat" has also been provided.  Clean will delete .obj, .lib, and .exe
  107. files from your various directories.  This is most useful when you want to
  108. recompile everything.  Saying "clean lib" will delete all your files from
  109. the lib directory.  "clean srclib" will delete the .obj files from your
  110. srclib directory.  "clean srccmd" will delete your .exe files.  "clean all"
  111. will do all of the above.
  112.  
  113. Good luck,
  114. Drew Perkins
  115.  
  116. arpanet: Drew.Perkins@andrew.cmu.edu
  117. phone:     (412) 268-8576
  118. US mail: Drew D. Perkins
  119.      Carnegie-Mellon University
  120.      4910 Forbes Ave.
  121.      Pittsburgh, PA 15213
  122.